# 2-点击上报

# 简介

该文档指导开发者在对接AdsConflux网盟平台时,如何使用Tracking Link 进行点击上报。

# 对接说明

  1. Tracking Link 获取

    • 拉取Offer API后,Offer返回实体中 "tracking_link"
  2. Tracking Link 上报

    • 上报时机: 推荐上报时机为用户点击广告,跳转Google Play Store时
    • 上报内容: 仅需替换{}中的宏,其他信息供AdsConflux核对信息用,开发者请勿修改
    • 上报形式: server to server (s2s) 上报
    • 注意事项: 部分参数在宏替换之后的值可能存在空格,上报前需进行encode编码
  3. Tracking Link 示例

    • 原始Tracking Link

    http://api.rethinkad.com/moonlight/v4?value=5146ea64xxx&click_id={click_id}&affiliate_id={affiliate_id}&idfa={idfa}&gaid={gaid}&imei={imei}&android_id={android_id}&mac={mac}&oaid={oaid}&ua={ua}&os_version={os_version}&device_model={device_model}&ip={ip}&country_code={country_code}&ext={ext}

    • 替换后Tracking Link(以非华为手机安卓为例)

    http://api.rethinkad.com/moonlight/v4?value=5146ea64xxx&click_id=4948d389-88a5-f63b-49b7-ff4831b5e21b&affiliate_id=YFQH&idfa={idfa}&gaid=d49bad8e-9fbf-442f-a5ee-87beb3492d10&imei={imei}&android_id={android_id}&mac={mac}&oaid={oaid}&ua=Dalvik/2.1.0%20(Linux;%20U;%20Android%206.0;%20ZTE%20BA520%20Build/MRA58K)&os_version={os_version}&device_model={device_model}&ip=101.72.203.33&country_code=IN&ext={ext}

  4. Tracking Link 参数说明

分类 参数名 类型 描述 是否必填
通用信息 value string 自带信息,可为空,无需开发者替换,请勿修改该值 N
affiliate_id string 渠道标识,从AM处获取 Y
channel string 渠道信息,取值:gp、other N
设备信息 imei string Android设备的设备标识
android_id string Android设备的设备标识
mac string 设备MAC地址,以MAC进行归因的Offer必传。注:若存在该类offer,投放前运营会单独与开发者沟通
uagent string 设备User-Agent Y
os_platform string 系统平台(ios/android),示例:android
os_version string 操作系统版本,示例:3.0
device_model string 设备型号,示例:vivo 1901
用户信息 gaid string Google广告平台的用户标识 Y
idfa string iOS设备的设备标识,iOS必传
oaid string 若用户使用华为手机,则gaid不存在,此时oaid必传
ip string 设备网络IP地址,开发者服务器端需要获取APP客户端外网IP并填入此字段,而非客户端本地获取的内网IP Y
country_code string ISO 3166-1 国际标准二位字母代码 (alpha-2),示例:CA、US。 country_code与ip需至少上报一个,建议二者均上报
ext 拓展个性化参数,最长100字符
归因信息 click_id string 开发者需为每次点击上报生成一个不重复的clickid,最长150个字符。若上报为空或者上报重复,则postback无法正确找到对应的上报点击,影响收入统计 Y
pkg_name string offer的应用包名 N
event string show - 展示 click - 点击 startDownload - 开始下载 download - 下载结束 startInstall - 开始安装 install-安装 (需按照当前枚举值进行替换,区分大小写) N
Last Updated: 3/28/2023, 2:57:03 PM